home *** CD-ROM | disk | FTP | other *** search
/ L' Effet Pommier 3 / L'Effet Pommier - Volume 03.iso / Education et Sciences / Mathématiques / gpower21 / G•Power Read Me < prev    next >
Text File  |  1996-02-02  |  10KB  |  271 lines
  1. ======================================================================== 
  2.               GÑPower for Macintosh, Version 2.1   January 1996
  3. ========================================================================
  4.  
  5. Contents of this document:
  6.  
  7. (1) Installation and registration
  8.  
  9. (2) What GÑPower does and how it works
  10.  
  11. (3) How to get GÑPower (i.e., where to check for future updates and versions for
  12. other platforms)
  13.  
  14. (4) Disclaimer
  15.  
  16.  
  17. A more detailed description of the program and its background will be available
  18. soon in printed form:
  19.  
  20. Erdfelder, E., Faul, F. & Buchner, A. (in press). GÑPower: A general power
  21. analysis program. Behavior Research Methods, Instruments, & Computers.
  22.  
  23. This article should appear very soon.
  24.  
  25. ======================================================================== 
  26. (1) Installation and registration
  27. ========================================================================
  28.  
  29. There are three versions of GÑPower:
  30.  
  31.  
  32. GÑPower PPC
  33.  
  34. is the version to use on Power Macintoshes.  It is amazingly fast.
  35.  
  36.  
  37. GÑPower
  38.  
  39. should run on any 68K Macintosh using System 7 or higher. It has also been tested
  40. successfully on some Power Macintosh models on which it runs in emulation mode. 
  41. Sorry, earlier system software versions are no longer supporeted.
  42.  
  43.  
  44. GÑPower FPU
  45.  
  46. is useful if your 68K Macintosh is equipped with a 68881 or 68882 arithmetic
  47. coprocessor (GÑPower/FPU is several times faster than GÑPower but it will not run
  48. on machines without FPU, both 68K or PowerMacs).  Again, you must have System 7
  49. or higher.
  50.  
  51. No special installation procedure is necessary to use GÑPower. Simply copy the
  52. program to your harddisk.  However, we recommend that you install only the
  53. version appropriate for your Macintosh.  Remove the other versions.
  54.  
  55. GÑPower is free. You may to give the program to friends and colleagues who might
  56. find it useful.
  57.  
  58. --------------------------------------------------------------------------------
  59. VERY IMPORTANT: If you want to include GÑPower on a Shareware or Freeware CD-ROM
  60. you MUST ask the authors for permission.  Contact us under the address given
  61. below.
  62. --------------------------------------------------------------------------------
  63.  
  64. Note that there is an MS-DOS version of GÑPower, so if your friends and
  65. colleagues use that platform, they can also work with GÑPower if they like (see
  66. Section (3) of this file for the FTP site to check for updates and the MS-DOS
  67. version of GÑPower).
  68.  
  69. We encourage you to let us know your complete address (including your e-mail
  70. address if possible) and the version of GÑPower you use. As a registered user,
  71. you will be informed about future program revisions. Your personal data will be
  72. used for this purpose only.  Please send this information to:
  73.  
  74. Axel Buchner
  75. FB I - Psychologie
  76. Universitèt Trier
  77. D-54286 Trier
  78. Germany
  79.  
  80. E-mail: buchner@cogpsy.uni-trier.de
  81.  
  82.  
  83. We also ask you to report any errors or problems encountered with GÑPower to the
  84. address mentioned in Section (4) of this file.
  85.  
  86. What follows is a brief description of the program (it takes no more than five
  87. minutes to read it).
  88.  
  89.  
  90.  
  91. ======================================================================== 
  92. (2) What it does and how it works
  93. ========================================================================
  94.  
  95. GÑPower performs high-precision statistical power analyses for the most common
  96. statistical tests in behavioral research, that is, t-, F-, and Chi2-tests. The
  97. power values obtained by ╥accuracy mode╙ calculations of GÑPower are correct up
  98. to five significant digits at least. Although available for taking a quick look
  99. at a problem, we do not encourage ╥speed mode╙ calculations because they are less
  100. accurate.
  101.  
  102. GÑPower computes
  103.  
  104. (a) power values for given sample sizes, effect sizes and alpha-levels (post hoc
  105. power analyses);
  106.  
  107. (b) sample sizes for given effect sizes, alpha-levels, and power values (a priori
  108. power analyses);
  109.  
  110. (c) alpha- and beta-values for given sample sizes, effect sizes and
  111. beta/alpha-ratios (compromise power analyses).
  112.  
  113. It also displays graphically the relation between any two of the relevant
  114. variables.
  115.  
  116.  
  117. ----------------------- The ╥Analysis window╙ -----------------------
  118.  
  119. The ╥Analysis window╙ is used to specify the information necessary for a
  120. particular power analysis, and it displays the results of the last analysis.
  121.  
  122. Click ╥Calculate╙ to perform a single analysis for the Type of Power Analysis,
  123. the Type of Test, and the parameters you specified.
  124.  
  125. Click ╥Calc ES╙ (where ES is d, r, f, f2,  or w, depending on the type of test
  126. currently selected) to open a dialog in which you can specify the values
  127. necessary to calculate the effect size for your power analysis from empirical
  128. data (e.g., from published studies).
  129.  
  130. Click ╥Draw graph╙ to open a dialog in which you can specify the values necessary
  131. to display one parameter (e.g., the power) as a function of another parameter
  132. (e.g., the total sample size) over a range of values (e.g., from 20 to 220
  133. subjects) in the ╥Graph window╙.
  134.  
  135. If the ╥Graph window╙ is already open, you can simply double-click this window to
  136. open the dialog in which you can specify the graph parameters.
  137.  
  138.  
  139. ------------------------- The ╥Graph window╙ -------------------------
  140.  
  141. The ╥Graph window╙ can be used to display one parameter (e.g., the power) as a
  142. function of another parameter (e.g., the total sample size) over a range of
  143. values  (e.g., from 20 to 220 subjects).
  144.  
  145. The header of the graph always specifies the type of test, and the fixed values.
  146. The note below the graph tells you what calculation mode you used. Default is
  147. ╥Accuracy mode╙ which is very accurate (up to five significant digits at least)
  148. but the price is that you will usually have to wait a little longer until you see
  149. a result. ╥Speed mode╙ calculations are fast but they may not be very accurate
  150. (particularly for ╘extreme╒ values). If you selected ╥Speed mode╙, do not trust
  151. the results too much!
  152.  
  153. You can copy the graph using ╥Copy graph╙ from the ╥Edit╙ menu and paste it into
  154. your word processor or drawing program documents for saving or editing the graph
  155. information. Inside GÑPower you cannot edit or save a graph.
  156.  
  157. The scaling of the axes in the ╥Graph window╙ depends on the size of the window,
  158. so re-sizing the window may have the effect of a more fine-grained scaling.
  159.  
  160. If the ╥Protocol (table)╙ option in the ╥Graph dialog╙ is on, a table of the
  161. values used to plot the graph is written to the Result window. This table can be
  162. imported into your favorite graphics package, either via the clipboard or by
  163. saving the table as a GÑPower file (see below).
  164.  
  165.  
  166. ------------------------- The ╥Result window╙ -------------------------
  167.  
  168. If the ╥Result window╙ is open, all parameters of all power analyses performed in
  169. the ╥Analysis window╙ are recorded here.
  170.  
  171. The ╥Result window╙ is fully editable (using the commands from the Edit menu).
  172. You can either copy the values you need to the clipboard, or you can save the
  173. entire information of the ╥Result window╙ to a GÑPower file using the Save or
  174. Save as commands from the File menu.
  175.  
  176. Double-clicking such a file launches GÑPower and opens the file so you can record
  177. more analyses in it. However, because GÑPower files are of type TEXT, they may
  178. also be opened from inside your favorite word processor or graphics package.
  179.  
  180.  
  181.  
  182. ======================================================================== 
  183. (3) How to get GÑPower
  184. ========================================================================
  185.  
  186. The most convenient way to get a copy of GÑPower is to download the program from
  187. the public FTP server at the University of Trier, Germany. This is where you
  188. should check for updates and future releases, and for versions for other
  189. platforms of GÑPower.  However, we will also try to make available updates and
  190. future releases of the Macintosh version on an info-mac archive near you.
  191.  
  192. There are two ways to access this server:
  193.  
  194. (I) Via WWW:
  195.  
  196. http://www.psychologie.uni-trier.de:8000/projects/gpower.html
  197.  
  198.  
  199. (II) Via FTP:
  200.  
  201. Host:        ftp.uni-trier.de
  202.  
  203. User ID:    anonymous
  204.  
  205. Password: Your e-mail address.
  206.  
  207. Directory:
  208.  
  209. (a) if you want the Macintosh-version of GÑPower:
  210.  
  211. /pub/mac/local
  212.  
  213. (b) if you want the MS-DOS-version of GÑPower:
  214.  
  215. /pub/pc/msdos
  216.  
  217. Set the file type to binary (omitting to set the file type properly is a frequent
  218. error!).
  219.  
  220. Start downloading (if you have to type in the file names, make sure you type them
  221. exactly as indicated below, this procedure is case-sensitive):
  222.  
  223. (a) if you want the MACINTOSH-version of GÑPower:
  224.  
  225. GPower21.sit
  226.  
  227. (b) if you want the MS-DOS-version of GÑPower:
  228.  
  229. GPower2i.exe (international version) or GPower2d.exe (German version)
  230.  
  231. 7. Finish the FTP session: quit
  232.  
  233. 8. Convert the compressed file to a standard Macintosh or DOS file:
  234.  
  235. (a) Macintosh-version: Open the file GPower2.sit from a version of StuffIt or use
  236. the Stuffit Expander.
  237.  
  238. (b) DOS-version (self-extracting archive): GPower2i.exe (international version)
  239. or GPower2d.exe (German version). This will create a subdirectory GPower in your
  240. current working directory which will contain all necessary files.
  241.  
  242.  
  243. ========================================================================
  244. (4) Address for correspondence
  245. ========================================================================
  246.  
  247. Please report bugs and suggestions to improve the program to:
  248.  
  249. Axel Buchner
  250. FB I - Psychologie
  251. Universitèt Trier
  252. D-54286 Trier
  253. Germany
  254.  
  255. E-mail: buchner@cogpsy.uni-trier.de
  256.  
  257.  
  258.  
  259. ========================================================================
  260. (5) Disclaimer
  261. ========================================================================
  262.  
  263. We hereby disclaim all warranties relating to this software, whether expressed or
  264. implied, including without limitation any implied warranties of merchantability
  265. or fitness for a particular purpose.  We will not be liable for any special,
  266. incidental, consequential, indirect or similar damages due to loss of data or any
  267. other reason, even if we or agents of ours have been advised of the possibility
  268. of such damages. In no event shall we be liable for any damages, regardless of
  269. the form of the claim. The person using the software bears all risk as to the
  270. quality and performance of the software.
  271.